home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / kardp10.zip / KARA.MAN < prev    next >
Text File  |  1994-11-13  |  6KB  |  149 lines
  1.  
  2. KARA.MAN                   USER COMMANDS               KARA.MAN
  3.  
  4. NAME
  5.      kara.exe
  6.  
  7. SYNOPSIS
  8.     [path1\]kara [path2\]song
  9.     [-do={v/f}] [-po={s/m}]
  10.     [-dc=y] [-tc=y]
  11.     [-sz=x] [-ft=x]
  12.     [-ff=x] [-nb=x] [-af=x] [-ab=x] [-pf=x]
  13.  
  14.      with x = numerical value (see OPTIONS)
  15.  
  16.  
  17. AVAILABILITY
  18.      The kara command is available within the kardp10.zip package
  19.      This package contains the KaraDos product delivery.
  20.      The package kards01.zip contains karaoke files collection 01
  21.  
  22. DESCRIPTION
  23.      kara  is  a  midi song player with karaoke features for dos.
  24.      Song  may be directed to the  Gravis UltraSound  card  (GUS)
  25.      internal synth with the  ultramid utility or directed to the
  26.      midi output of the  GUS or SoundBlaster and compatible card.
  27.      The hardware is automatically detected.
  28.  
  29.      Text is directed to the screen in  either  full screen  with
  30.      full background and foreground colors capacity and choice of
  31.      characters size and style, or either in a video mode used to
  32.      become embedded in a video signal on tv set at the bottom of
  33.      the screen. In video mode the background color is black.
  34.  
  35.      Two kind of song files are understood by kara :
  36.        - midi file with .mid extension
  37.        - karaoke file with .kar extension (karasoft format)
  38.      Midi files must have a text file associated  with each song.
  39.      The file name of these text files must be  the same  as  the
  40.      midi file with a .txk extension. Synchronization is  made on
  41.      the note on and off of a  midi channel. A  complete descrip-
  42.      tion of the .txk format is done in the following.
  43.  
  44.      While playing, the music can be stopped, continued, transpo-
  45.      sed. The tempo can be adjusted and the volume of the  synch-
  46.      ronization channel tuned. Valid keys are space to start  and
  47.      stop the music, r (rythm) t (transpose) v (volume)  followed
  48.      with + or -, and esc to quit.
  49.      For each key, an indication is briefly displayed at the left
  50.      upper corner of the screen.
  51.      Note on the volume: with a .mid & .txk set,  the  volume  is
  52.      adjusted only for the synchro channel.
  53.      For a .kar file, the volume is adjusted for all channels.
  54.      Another key M (monitor) will play the music on the pc speaker
  55.      (channel 1 to 8 only << only for debug  don't  use  for  your
  56.      health >>)
  57.  
  58. OPTIONS
  59.      OPTION     COMMENT                                   DEFAULT
  60.      ------------------------------------------------------------
  61.   kara options
  62.      -do={v/f}  display text in full screen or video mode    do=f
  63.      -po={s/m}  music to ultramid (synth) or midi port       po=s
  64.     music options
  65.      -dc={1.16} drum channel number                         dc=10
  66.      -tc={1.16} text synchro channel (for .mid file)         tc=1
  67.   screen options
  68.      -sz={0.10}  size of the text on the screen              sz=4
  69.      -ft={0.4}  type of font                                 ft=1
  70.   line options
  71.      -ff={0.15} first text foreground color                 ff=15
  72.      -nb={0.15} normal background color in full screen       nb=1
  73.      -af={0.15} active text foreground color                 af=0
  74.      -ab={0.15} active text background color in full screen ab=14
  75.      -pf={0.15} post text foreground color                   pf=3
  76.  
  77. COLORS
  78.                          Back-|Fore-
  79.      Constant     |Value|grnd?|grnd?
  80.     -------------------------------
  81.      BLACK        |  0  | Yes | Yes
  82.      BLUE         |  1  | Yes | Yes
  83.      GREEN        |  2  | Yes | Yes
  84.      CYAN         |  3  | Yes | Yes
  85.      RED          |  4  | Yes | Yes
  86.      MAGENTA      |  5  | Yes | Yes
  87.      BROWN        |  6  | Yes | Yes
  88.      LIGHTGRAY    |  7  | Yes | Yes
  89.      DARKGRAY     |  8  | Yes | Yes
  90.      LIGHTBLUE    |  9  | Yes | Yes
  91.      LIGHTGREEN   | 10  | Yes | Yes
  92.      LIGHTCYAN    | 11  | Yes | Yes
  93.      LIGHTRED     | 12  | Yes | Yes
  94.      LIGHTMAGENTA | 13  | Yes | Yes
  95.      YELLOW       | 14  | Yes | Yes
  96.      WHITE        | 15  | Yes | Yes
  97.     -------------------------------
  98.  
  99.  
  100. FORMAT
  101.      Format of the .txk ascii file :
  102.      -------------------------------
  103.      The two  first lines are reserved for the  title, author and
  104.      copyright if any.
  105.      Following  lines are a mix of text lines and attribut lines.
  106.  
  107.      Text lines  are  as you want to see it on the  screen  apart
  108.      a syllable separator. Valid separators are blank - , ;
  109.      the - separator is not displayed
  110.      for example the line: i be-come la-zy
  111.      is displayed as : i become lazy  but is "karaoked" as :
  112.      i be come la zy     . It is more  easy to understand than to
  113.      explain.
  114.  
  115.      Attribut lines begin with # followed with one option descri-
  116.      bed in the OPTIONS . Warning: the # replace the - character.
  117.      A new option is added : #rem for adding a comment line.
  118.      Kara option #do and #po are disabled and will not work.
  119.      Only music, screen and line options will be given in a  .txk
  120.      file.
  121.      A line option remains valid until the same is given.
  122.      The screen options taken into account are the last given.
  123.  
  124.      .txk options cannot be overloaded with options given in  the
  125.      command line.
  126.  
  127.  
  128.      Formatting the ascii text in .kar file :
  129.      ----------------------------------------
  130.      A text beginning with the character / or with an uppercase
  131.      is displayed on a new line.
  132.      A text beginning with the character \ is displayed after two
  133.      empty line ( note: normally it will be a new screen. It's my
  134.      choice).
  135.  
  136.  
  137. SEE ALSO
  138.      kdir.man
  139.  
  140. BUGS AND RESTRICTIONS
  141.      Some font and size combinations may not work perfectly.
  142.      Files *.chr and *.bgi must reside in the same directory as
  143.      kara.exe.
  144.      Files .txk must be in the same directory than corresponding
  145.      .mid files
  146.      Some karaoke files may be too large to fit in DOS memory.
  147.  
  148. KaraDos release 1.0  Last change: 03 November 1994  (c)JP COCATRIX
  149.